home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games Extra 1996 September / Amiga Games Extra CD-ROM 9-1996.iso / userbox / publicdomain / vim-4.2 / doc / vim_os2.txt < prev    next >
Text File  |  1996-06-16  |  5KB  |  97 lines
  1. *vim_os2.txt*   For Vim version 4.2.  Last modification: 1996 June 13
  2.  
  3. This file contains the particularities for the OS/2 version of Vim.
  4.  
  5.  
  6. Note: This OS/2 port works well for me and a couple of other OS/2 users;
  7.       however, since I haven't had much feedback, that either means no
  8.       (OS/2-specific) bugs exist (besides the one mentioned below), or no one
  9.       has yet created a situation in which any bugs are apparent.  Report any
  10.       problems or other comments to paul@wau.mis.ah.nl (email valid up to at
  11.       least September 1996, after that try paul@wurtel.hobby.nl,
  12.       paul@murphy.nl, or paulS@toecompst.nl).  Textmode/notextmode, binary
  13.       mode, and FAT handling all seem to work well, which would seem to be the
  14.       most likely places for trouble.
  15.  
  16.       A known problem is that files opened by Vim are inherited by other
  17.       programs that are started via a shell escape from within Vim.
  18.       This specifically means that Vim won't be able to remove the swap
  19.       file(s) associated with buffers open at the time the other program was
  20.       started, until the other program is stopped. At that time, the swap file
  21.       may be removed, but if Vim could not do that the first time, it won't be
  22.       removed at all. You'll get warnings that some other Vim session may be
  23.       editing the file when you start Vim up again on that file.  This can be
  24.       reproduced with ":!start epm". Now quit Vim, and start Vim again with
  25.       the file that was in the buffer at the time epm was started.  I'm
  26.       working on this!
  27.  
  28.  
  29. Prerequisites:
  30.  
  31. - To run Vim, you need the emx runtime environment (at least rev. 0.9b).  This
  32.   is generally available as (ask Archie about it):
  33.  
  34.     emxrt.zip     emx runtime package
  35.  
  36.   I've included a copy of emx.dll, which should be copied to one of the
  37.   directories listed in your LIBPATH. Emx is GPL'ed, but the emx.dll library
  38.   is not (read COPYING.EMX to find out what that means to you).
  39.  
  40.   This emx.dll is from the emxfix04.zip package, which unfortunately has a bug
  41.   in select().  Versions of Vim before 3.27 will appear to hang when starting
  42.   (actually, while processing vimrc). Hit return a couple of times until Vim
  43.   starts working if this happens.  Next, get an up to date version of Vim!
  44.  
  45. The VIM environment variable is used to find the location of the help files
  46. and the system .vimrc. Place an entry such as this in CONFIG.SYS:
  47.  
  48. SET VIM=c:/local/lib/vim
  49.  
  50. and copy all the vim_*.txt files and .vimrc to that directory. Vim will then
  51. be able to find them.
  52.  
  53. Note: .vimrc may also be called _vimrc to accommodate those who have chosen to
  54. install OS/2 on a FAT file system. Vim first tries to find .vimrc and if that
  55. fails, looks for _vimrc in the same place.
  56.  
  57. If you're using network drives with OS/2, then you can install Vim on a
  58. network drive (including .vimrc; this is then called the "system" vimrc file),
  59. and then use a personal copy of .vimrc (the "user" vimrc file). This should be
  60. located in a directory indicated by the HOME environment variable.
  61.  
  62. This HOME environment variable is also used when using ~ in file names, so
  63. ":e ~/textfile" will edit the file "textfile" in the directory referred to by
  64. HOME.  Additionally you can use other environment variables in file names, as
  65. as ":n $SRC/*.c".
  66.  
  67. If the HOME environment variable is not set, the value "C:/" is used as a
  68. default.
  69.  
  70. Using slashes ('/') and backslashes ('\') can be a bit of a problem (see
  71. vim_dos.txt for more explanation), but in almost all cases Vim does "The Right
  72. Thing".  Vim itself uses backslashes in file names, but will happily accept
  73. forward slashes if they are entered (in fact, often that works better!).
  74.  
  75. Use "os2ansi" as the TERM environment variable (or don't set it at all, as the
  76. default is the correct value). You can set term to os2ansi in the .vimrc, in
  77. case you need TERM to be a different value for other applications.  The
  78. problem is that OS/2 ANSI emulation is quite limited (it doesn't have insert /
  79. delete line, for example).
  80.  
  81. If you want to use a different value for TERM (because of other programs, for
  82. example), make sure that the termcap entry for that TERM value has the
  83. appropriate key mappings. The termcap.dat distributed with emx does not always
  84. have them.  Here are some suitable values to add to the termcap entry of your
  85. choice; these allow the cursor keys and the named function keys (such as
  86. pagedown) to work.
  87.  
  88.     :ku=\316H:kd=\316P:kl=\316K:kr=\316M:%i=\316t:#4=\316s:\
  89.     :kD=\316S:kI=\316R:kN=\316Q:kP=\316I:kh=\316G:@7=\316O:\
  90.     :k1=\316;:k2=\316<:k3=\316=:k4=\316>:k5=\316?:k6=\316@:\
  91.     :k7=\316A:k8=\316B:k9=\316C:k;=\316D:
  92.  
  93.  
  94. Paul Slootman
  95.  
  96. vim:ts=8:tw=78:
  97.